This page last changed on Dec 04, 2005 by vidya.

You need to edit in 'Wiki Markup' mode to include macros in your page.


The Jira Issues Macro allows you to display JIRA issues matching any JIRA filter within a page in Confluence.

To do this, you need to include the url of the JIRA search filter in the macro.

JIRA Issues Macro

To retrieve a jira_rss_url,

  1. Perform a search in JIRA. At the top of the 'Issue Navigator' page, you will see various available views for that filter. See Screenshot 1.

  2. Right click on 'XML' and copy its link location. See Screenshot 2.

  3. Paste the url into the JIRA Issues macro in your page in Confluence.

The command for copying a link to the clipboard may depend on your browser.

Screenshot 1 : Issue Navigator views

Screenshot 2 : Copy to clipboard


Optional Parameters

Customize the list of issues and the order of the columns being displayed by specifying a columns parameter

Use a semi-colon delimited list to specify which of the jira columns you want included and in what order you want them presented.

JIRA column names include:

  • Key
  • Summary
  • Type
  • Created
  • Updated
  • Assignee
  • Reporter
  • Priority
  • Status
  • Resolution

Here's an example:

{jiraissues:url=http://jira.atlassian.com/secure/IssueNavigator.jspa?view=rss&pid=10470&fixfor=10650&sorter/field=issuekey&sorter/order=DESC&tempMax=25&reset=true|columns=type;key;summary}

will result in:

Atlassian JIRA (3 issues)
T Key Summary
Bug CONF-495 Problem with incoming links
Bug CONF-496 Problem with rename
Bug CONF-497 Search includes old versions of pages

Warning

Some issue feeds in JIRA can only be accessed if the user has the necessary rights in the JIRA project for which those issues belong. Hence when you paste that URL in Confluence, you will need to append your login information at the end of the URL, so that JIRA knows who is requesting the feed and is able to check permissions accordingly. That is,

{jiraissues:url=http://host.com/secure/IssueNavigator.jspa?&os_username=username&os_password=password\}

Failing to do this will result in a "Error rendering macro" error.

RELATED TOPICS

Working with Macros

Take me back to Confluence 2.0 Home

Screenshot images don't display on this page. They would be helpful.

Posted by skeddy at Apr 08, 2006 04:45

Does the jiraissues macro support the https protocol?

Posted by sdockery@ariasolutions.com at Apr 21, 2006 19:18

I also posted this question here, but I am more interested in whether or not this is support under Confluence 2.x. My bad for posting it in the wrong location to begin with.

Posted by sdockery@ariasolutions.com at Apr 21, 2006 19:19

Hi sean. We are using the https protocol with this macro and it works fine.

Posted by ben@customware.net at May 22, 2006 20:33
Document generated by Confluence on Jun 14, 2006 00:28